home *** CD-ROM | disk | FTP | other *** search
/ Ultra Pack / UltraComputing Partner Applications.iso / Adobe / INSTGUID.TXT < prev    next >
Text File  |  1995-11-01  |  18KB  |  493 lines
  1. Introducing Adobe Acrobat Reader 2.1
  2. ------------------------------------
  3.  
  4. Welcome to Adobe(TM) Acrobat(TM) Reader software-Version 2.1 for UNIX (R). This
  5. guide tells you how to install Acrobat Reader on your workstation.
  6.  
  7. Acrobat Reader is part of the Adobe Acrobat family of software, which lets you
  8. view, distribute, print, and save documents in Portable Document Format (PDF)
  9. regardless of the computer, operating system, fonts, or application used to
  10. create the original file. PDF files retain all the formatting, fonts, and
  11. graphics of the original document, and virtually any PostScript(TM) document can
  12. be converted into PDF. On UNIX systems, PDF files can be created using the
  13. Acrobat Distiller(TM) program; on Macintosh(R) and Windows(TM) systems, they can
  14. be created using Acrobat Exchange and Acrobat Distiller or the Acrobat PDF
  15. Writer printer driver.  In addition, some applications, such as Adobe
  16. Illustrator 5.5, can save documents directly as PDF files.
  17.  
  18. To install Acrobat Reader on your workstation, you must be familiar with basic
  19. UNIX commands. If you are not, please consult with your system administrator
  20. before beginning this installation.
  21.  
  22.  
  23. About This Guide
  24. ----------------
  25.  
  26. Before you begin using Acrobat Reader, be sure to read this guide for
  27. installation instructions and other important information. This guide contains
  28. the following information:
  29.  
  30.  - Instructions for installing the Acrobat Reader software
  31.  - System administration information, such as how to move or remove the files
  32.  - Troubleshooting information
  33.  
  34.  
  35. About the Acrobat Reader Software Package
  36. -----------------------------------------
  37.  
  38. The Acrobat Reader software package includes a CD-ROM containing the Acrobat
  39. Reader program file and associated files, and the following documents in online
  40. form:
  41.  
  42.  - Acrobat Reader Online Guide explains how to use and customize the Acrobat 
  43.    Reader software.
  44.  - Adobe Acrobat Reader Installation and Getting Started Guide is this manual. 
  45.    It describes how to install the Acrobat Reader files.
  46.  
  47.  
  48. System Requirements and Limitations
  49. -----------------------------------
  50.  
  51. To use Acrobat Reader software, you need the following minimum hardware and
  52. software:
  53.  
  54. If you're using a Sun SPARCstation workstation
  55.  
  56.  - Solaris 1.1, 2.3, or 2.4 operating system software (Acrobat Reader will not 
  57.    run under Solaris 2.0, 2.1, or 2.2.)
  58.  - OpenWindows (version 3.0 or later), Motif window manager (1.2.3 or later), 
  59.    or OpenLook version 3.0
  60.  - CD-ROM drive
  61.  - 8 megabytes of available hard disk space 
  62.  - 8 megabytes of RAM
  63.  
  64. If you're using an HP workstation
  65.  
  66.  - 9000 series workstation
  67.  - HP-UX 9.0.3 or later operating system software 
  68.  - X Window System X11R5 running HP-VUE
  69.  - CD-ROM drive
  70.  - 8 megabytes of available hard disk space 
  71.  - 32 megabytes of RAM
  72.  
  73.  
  74. Upgrading From Acrobat 1.0
  75. --------------------------
  76.  
  77. The Acrobat Reader installation script installs the Reader files into a new
  78. directory. If you have an earlier version of the Reader software, it is not
  79. removed automatically. For more information on removing the files, see "Removing
  80. Acrobat Reader Software."
  81.  
  82.  
  83. Preparing For installation
  84. --------------------------
  85.  
  86. Before beginning the installation, decide where to install the Acrobat Reader
  87. files. The following sections describe the installation options. Review these
  88. sections carefully before installing the software.
  89.  
  90. Local Versus Network Installation
  91.  
  92. Determine whether a local (stand-alone workstation) or network installation is
  93. more appropriate for your situation.
  94.  
  95. For local installation: A local installation guarantees access to the software
  96. from a workstation and may significantly improve performance, depending on how
  97. much activity there is on the network. To install Reader on your workstation,
  98. you must have the root password for the workstation and access to a CD-ROM
  99. drive.
  100.  
  101. For network installation: A network installation makes administrative and
  102. maintenance tasks easier, particularly when many users want to access the
  103. software concurrently. It is easier to upgrade a single copy of software 
  104. installed on a server than to upgrade multiple copies installed on stand-alone
  105. workstations.
  106.  
  107. Note: Network installation should be performed by a system or network
  108. administrator.
  109.  
  110. If you perform a network installation, you will need to find appropriate network
  111. locations for the installation directory. The software should be installed on a
  112. network server machine with high reliability. In addition, the installation
  113. files should be placed in a location that is remotely mounted at the same
  114. location on all machines.
  115.  
  116. Choosing an Installation Directory
  117. ----------------------------------
  118.  
  119. Locate a directory and verify that you have at least 8 megabytes of available
  120. disk space. The default location for installation of the Acrobat Reader software
  121. is the /usr/AcroRead directory for SunOS and HP, and the /opt/AcroRead directory
  122. for Solaris 2. If there is insufficient space in this partition, choose another
  123. directory within a different partition.  Use the df command to determine the
  124. available space within a file system partition containing a particular
  125. directory. Type df followed by the name of the directory in which you want to
  126. install the software. For example, on Solaris:
  127.  
  128. # df /usr
  129.  
  130. Filesystem  kbytes    used     avail   capacity  Mounted on
  131. /dev/sd0g   207295  98377  88189  53%        /usr
  132.  
  133. There are 207,295 kilobytes (about 207 megabytes) in this partition and about 88
  134. megabytes available, which is enough disk space to install the Acrobat Reader
  135. software. See your system documentation for more information on the df command.
  136.  
  137.  
  138. Installing the Acrobat Reader Software
  139. --------------------------------------
  140.  
  141. Acrobat Reader software is distributed on CD-ROM. This section contains
  142. instructions about loading the CD-ROM and installing the Reader software from a
  143. CD-ROM drive attached to your workstation.
  144.  
  145. Loading the CD-ROM
  146.  
  147. You can install the software from a CD-ROM drive attached to your local
  148. workstation. If the CD-ROM drive isn't mounted, you must log in as root to mount
  149. it.
  150.  
  151. If your CD-ROM drive requires a caddy, put the CD-ROM in a caddy and insert the
  152. caddy into the drive. If your CD-ROM drive does not use a caddy, load the disc
  153. directly into the drive. Load the disc so the printed side is facing up.
  154.  
  155. Note: If your CD-ROM drive requires a caddy and you put the CD-ROM into the
  156. drive without a caddy, both the disc and the drive may be damaged.
  157.  
  158. Checking If the CD-ROM Drive Is Mounted
  159.  
  160. Depending on how your workstation is configured, your CD-ROM drive may be
  161. mounted automatically. If the CD-ROM drive is not mounted, you must mount it
  162. before you can install the Reader software.
  163.  
  164. On Solaris 2.3 or 2.4 workstations, the CD-ROM icon appears on the desktop if
  165. your CD-ROM drive is mounted.
  166.  
  167. On other Solaris, SunOS, or HP workstations, determine whether the CD-ROM drive
  168. is mounted by typing:
  169.  
  170. # /etc/mount
  171.  
  172. You should see a list of mounted file systems. The CD-ROM drive is mounted on
  173. your local workstation if a line similar to the following appears in the list:
  174.  
  175.  - If you're using SunOS or Solaris:
  176.  
  177.     /dev/sr0 on /cdrom
  178.  
  179.  - If you're using HP-UX:
  180.  
  181.     /cdrom on device readonly on date
  182.  
  183. where device depends on your system. Check your reference manuals or ask your
  184. system administrator.
  185.  
  186. If the CD-ROM drive is not mounted, see "Mounting the CD-ROM Drive" next.
  187.  
  188. Mounting the CD-ROM Drive
  189.  
  190. To mount a CD-ROM drive, you must know your system's root password. If you don't
  191. know the password, contact your system administrator.
  192.  
  193. To mount the drive on a local workstation:
  194.  
  195. 1 Open a UNIX window.
  196.  
  197. 2 Become the root user and type the root password:
  198.     % su root
  199.     Password: <root_password>
  200.  
  201. 3 Create the /cdrom directory:
  202.     # mkdir /cdrom; chmod a+rwx /cdrom
  203.  
  204. 4 Mount the CD-ROM drive.
  205.     - If you're using SunOS, type:
  206.         # /etc/mount -rt hsfs /dev/sr0 /cdrom
  207.  
  208.     - If you're using Solaris 2, type:
  209.         # /etc/mount -F hsfs -r /dev/sr0 /cdrom
  210.  
  211.     - If you're using HP, type:
  212.         # /etc/mount device /cdrom -r -t cdfs
  213.  
  214.   where device depends on your system. Check your reference manuals or ask your
  215.   system administrator.
  216.  
  217. 5 Verify that the drive was mounted:
  218.     # /etc/mount
  219.  
  220. You should see a list of mounted file systems, including the CD-ROM drive you
  221. just mounted.
  222.  
  223.  
  224. Running the Installation Script
  225. -------------------------------
  226.  
  227. The installation script prompts you to answer questions regarding the
  228. installation, such as where you want to place the Reader files. Reasonable
  229. default values are provided. Press Return to select the recommended defaults, or
  230. enter your own values.
  231.  
  232. If you make a mistake, you can do either of the following: 
  233.  
  234.  - Exit at different points in the procedure.
  235.  
  236.  - Press the interrupt key sequence (Control+C on most UNIX systems) to
  237.    cancel the installation.
  238.  
  239. To run the installation script:
  240.  
  241. 1 If you don't have write privilege to the installation directory, become
  242.     the root user and type the root password:
  243.     % su root
  244.     Password: <root_password>
  245.  
  246. 2 Change to the Acrobat Reader directory on the CD-ROM:
  247.     # cd /cdrom/acroread
  248.  
  249. 3 Start the installation script:
  250.     - If you're using SunOS or Solaris 2, type:
  251.         # ./install
  252.     - If you're using HP, type:
  253.         # ./INSTALL
  254.  
  255. 4 Follow the instructions that appear on your screen.
  256.  
  257. When the installation is complete, a message appears indicating that you have
  258. installed the software successfully. Acrobat Reader is now installed.
  259.  
  260. Integrating Icons Into the OpenWindows Desktop
  261.  
  262. Acrobat Reader provides a script that integrates Acrobat Reader icons into your
  263. OpenWindows desktop. Skip this section if you are using the Motif window
  264. manager.
  265.  
  266. You can run this script as root or from your login account. If you are logged in
  267. as root, the icons are installed for all users. If you run the script as a
  268. normal user, the icons are installed for your use only.
  269.  
  270. To integrate icons into the desktop:
  271.  
  272. 1 In a UNIX shell window, as root, locate the acroread.deskinstall script:
  273.     # cd <installdir>/desktop/olwm
  274.  
  275. 2 Run the acroread.deskinstall script:
  276.     # ./acroread.deskinstall
  277.  
  278. 3 Exit from OpenWindows, and log back on for the changes to take effect. 
  279.  
  280. Creating Links To the Launch Script
  281.  
  282. You should always start Acrobat Reader using its launch script. To make it
  283. easier to use the script, you can create links to the launch script
  284. directory. The following example creates a link from the /usr/bin directory:
  285.  
  286. # ln -s /opt/AcroRead/bin/acroread /usr/bin/acroread
  287.  
  288. Acrobat Reader Installed Files
  289.  
  290. The installation script installs the following files and directories in the
  291. installation directory:
  292.  
  293.  - The bin directory contains the acroread launch script.
  294.  - The desktop directory contains files for desktop integration.
  295.  - The fonts directory contains bundled fonts.
  296.  - The Help directory contains the Acrobat Reader Online Guide, the Weblink 
  297.    Online Guide, and the ReadMe file.
  298.  - The res directory contains pixmap and bitmap resources.
  299.  - The Tutorial directory contains sample PDF files.
  300.  
  301.  
  302. Starting the Acrobat Reader
  303. ---------------------------
  304.  
  305. Now that you have completed the installation procedure, you are ready to start
  306. the Acrobat Reader application. Always start the Reader application by using its
  307. launch script.
  308.  
  309. If you created symbolic links, and the alternative launch script directory is in
  310. the search path set by the PATH environment variable, you can start Acrobat
  311. Reader by typing this:
  312.  
  313. % acroread
  314.  
  315. If you did not create symbolic links to the launch scripts, type the following
  316. command to start Acrobat Reader:
  317.  
  318. % <installdir>/bin/acroread
  319.  
  320. To launch Acrobat Reader so that it appears as an icon on your desktop, type the
  321. following command:
  322.  
  323. % acroread -iconic
  324.  
  325. To view one or more files, give the filenames as command-line parameters. For
  326. example, to view /share/docs/annual_report.pdf and /user/bob/Schedule.pdf, type:
  327.  
  328. % acroread /share/docs/annual_report.pdf /user/bob/Schedule.pdf
  329.  
  330. The acroread launch script and the acroread_frontend program ensure that only
  331. one version of Reader runs on your desktop. If you type the command acroread
  332. <filename> when Reader is already running, the currently running version of
  333. Reader loads and displays the specified file.
  334.  
  335. If you prefer that a new version of Reader be launched each time you start
  336. Reader, type the following command:
  337.  
  338. % acroread +useFrontEndProgram
  339.  
  340. Converting PDF To Postscript
  341.  
  342. You can convert PDF files to level 1 or level 2 PostScript files from the
  343. command line if you are running the X Window System.
  344.  
  345. To convert a PDF file by piping it into Reader and then sending the output to
  346. standard output, type:
  347.  
  348. % cat sample.pdf | acroread -toPostScript > sample.ps 
  349.  
  350. To convert one or more PDF files, such as sample1.pdf and sample2.pdf, into
  351. PostScript files and place these PostScript files into the directory <dir>,
  352. type:
  353.  
  354. % acroread -toPostScript sample1.pdf sample2.pdf <dir>
  355.  
  356. To convert a series of files expressed as both a PDF filename and a
  357. corresponding PostScript filename (or pairs), type:
  358.  
  359. % acroread -toPostScript -pairs pdf_file_1 ps_file_1 ...
  360.  
  361. To convert a PDF file to a level 2 PostScript file, type:
  362.  
  363. % acroread -toPostScript -level2 pdf_file_1
  364.  
  365.  
  366. Managing Acrobat Reader
  367. -----------------------
  368.  
  369. This section is for system administrators who need information about managing
  370. the Acrobat Reader installation directory.
  371.  
  372. Removing Acrobat Reader Software
  373.  
  374. You can remove the Acrobat Reader software by manually deleting the files and
  375. directories that were created during the installation procedure.
  376.  
  377. As the superuser (root account), enter the following commands to remove Reader
  378. from the installation directory:
  379. # cd <installdir>
  380. # rm -rf acroread
  381.  
  382. To remove the symbolic link to the launch script, delete the file
  383. /usr/bin/acroread:
  384. # cd /usr/bin
  385. # rm acroread
  386.  
  387.  
  388. Troubleshooting
  389. ---------------
  390.  
  391. This section describes Acrobat Reader error messages and provides general
  392. troubleshooting information.
  393.  
  394. Command To Launch Acrobat Reader Not Found
  395.  
  396. Error message: acroread: Command not found
  397.            or  acroread: not found
  398.  
  399. Cause: Either the Acrobat Reader launch script is not on your search path or the
  400. launch script you are trying to execute is actually a symbolic link to a file
  401. that does not exist.
  402.  
  403. Solution: Locate the file that is launching the application by typing the
  404. command which acroread in a UNIX shell. This command gives you the name of the
  405. file that is executed when you issue the acroread command.
  406.  
  407. Perform a long listing on the file that executes Acrobat Reader:
  408.  
  409. % ls -l acroread
  410.  
  411. If the results indicate that acroread is actually a symbolic link to another
  412. file (<file>), type the following:
  413.  
  414. % ls -l <file> 
  415.  
  416. Continue this process until you have a real file (not a symbolic link) or until
  417. you receive the message "<file> not found." If you receive this message and
  418. Reader was not installed locally, then the network volume holding the Reader
  419. installation may be temporarily down or may have been moved to a new location,
  420. or the Reader distribution may have been moved or deleted so that the symbolic
  421. links are pointing to an invalid location.
  422.  
  423. To resolve this problem:
  424. Reinstall the software, carefully following the instructions in this guide.
  425.  
  426. Permission Denied To Launch Acrobat Reader
  427.  
  428. Error message: acroread: Permission denied
  429.  
  430. Cause: One or more files have their permissions set incorrectly. 
  431.  
  432. Solution: Examine the permissions on the Reader launch script to make sure you
  433. have proper execute privileges for <installdir>/bin/acroread.
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441. 1995 Adobe Systems Incorporated. All rights reserved.
  442. Adobe Acrobat Reader 2.1 Installation Guide for UNIX
  443.  
  444. This manual, as well as the software described in it, is furnished under license
  445. and may be used or copied only in accordance with the terms of such license. The
  446. information in this manual is furnished for informational use only, is subject
  447. to change without notice, and should not be construed as a commitment by Adobe
  448. Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or
  449. liability for any errors or inaccuracies that may appear in this manual.
  450.  
  451. Except as permitted by such license, no part of this publication may be
  452. reproduced, stored in a retrieval system, or transmitted, in any form or by any
  453. means, electronic, mechanical, recording, or otherwise, without the prior
  454. written permission of Adobe Systems Incorporated.
  455.  
  456. Adobe, the Adobe logo, Acrobat, the Acrobat logo, Distiller, Adobe Illustrator,
  457. and PostScript are trademarks of Adobe Systems Incorporated or its subsidiaries
  458. and may be registered in certain jurisdictions. Macintosh is a registered
  459. trademark of Apple Computer, Inc. HP is a registered trademark and HP-UX is a
  460. trademark of Hewlett-Packard Company. Motif is a trademark of Open Software
  461. Foundation, Inc. Solaris is a registered trademark of Sun Microsystems, Inc.,
  462. which has not tested or approved this product. Sun and OpenWindows are
  463. trademarks of Sun Microsystems, Inc. SPARC is a registered trademark of SPARC
  464. International, Inc. SPARCstation is a registered trademark of SPARC
  465. International, Inc., licensed exclusively to Sun Microsystems, Inc. and is based
  466. upon an architecture developed by Sun Microsystems, Inc. UNIX is a registered
  467. trademark in the United States and other countries, licensed exclusively through
  468. X/Open Company, Ltd. Windows is a trademark of Microsoft Corporation. X Window
  469. System is a trademark of the Massachusetts Institute of Technology. All other
  470. products or name brands are trademarks of their respective holders.
  471.  
  472. Contains an implementation of the LZW algorithm licensed under U.S. Patent
  473. 4,558,302.
  474.  
  475. Written and designed at Adobe Systems Incorporated, 1585 Charleston Road,
  476. Mountain View, CA 94039-7900, USA
  477.  
  478. Adobe Systems Europe Limited, Adobe House, Edinburgh EH11 4DU, Scotland, United
  479. Kingdom Adobe Systems Co., Ltd., Yebisu Garden Place Tower, 4-20-3 Ebisu,
  480. Shibuya-ku, Tokyo 150, Japan
  481.  
  482. For defense agencies: Restricted Rights Legend. Use, reproduction, or disclosure
  483. is subject to restrictions set forth in subparagraph (c)(1)(ii) of the Rights in
  484. Technical Data and Computer Software clause at 252.227-7013.
  485.  
  486. For civilian agencies: Restricted Rights Legend. Use, reproduction, or
  487. disclosure is subject to restrictions set forth in subparagraphs (a) through (d)
  488. of the commercial Computer Software Restricted Rights clause at 52.227-19 and
  489. the limitations set forth in Adobe's standard commercial agreement for this
  490. software. Unpublished rights reserved under the copyright laws of the United
  491. States.
  492.  
  493.